home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 September / CHIP Eylül 1998.iso / Slackwar / contrib / xgrabsc.txt < prev   
Text File  |  1996-10-24  |  6KB  |  152 lines
  1. *========================================================================
  2. *
  3. * Name - README
  4. *
  5. * Version:    1.16
  6. *
  7. * ccsid:    @(#)README    1.16 - 08/16/95 08:16:28
  8. * from:     ccs/s.README
  9. * date:     11/07/95 11:31:39
  10. *
  11. * Copyright (C) 1990-92 Bruce Schuchardt
  12. * See either the man page or the file cpyright.h for full copyright
  13. * information.
  14. *
  15. * Description:  README for xgrabsc
  16. *
  17. *        Notes for this specific release are in README.xx_yy
  18. *
  19. *========================================================================
  20.  
  21. (Xgrabsc version 2.41)
  22.  
  23. INTRO TO xgrabsc
  24.  
  25. When I first wrote xgrabsc, there were a number of programs available
  26. for getting X-Window screen dumps (e.g., xwd and xwps), but they
  27. were all restricted to dumping a single window in a single format.
  28. I wrote xgrabsc in an effort to get around these restrictions.
  29.  
  30. The main contribution of this program is its use of root-window
  31. rubberbanding to allow capture of arbitrary portions of the screen,
  32. and its multiple output formats (x-bitmap, portable-bitmap, x-pixmap, xwd,
  33. puzzle, "simple", and several Postscript formats).
  34.  
  35. The Postscript dumps will use run-length encoding if it results in
  36. any savings in size.  A typical xterm window dump on a mono system
  37. runs around 40K bytes (20K for binary output).  An xwd dump on the
  38. same screen will be around 650K bytes.  While the xpr program has a
  39. "compress" option, it only compresses white samples.  Reducing the 
  40. size of the output increases the cost of computing the dump and the
  41. final printing of the dump, but it reduces the cost of storage and
  42. the time to transfer the dump to your printer.  The latter is
  43. especially important for large screen dumps.
  44.  
  45. The xgrabsc program is not interactive.  You specify all processing
  46. options on the command line with obscure option characters.  These
  47. are all detailed in the man page.  An interactive interface to xgrabsc,
  48. named xgrab, is also included in this release.  xgrab allows you to
  49. do most of the setup with a mouse, and then uses the xgrabsc program
  50. to actually do the processing.  To use xgrab you must have the xgrabsc
  51. program in your execution path.
  52.  
  53.  
  54.  
  55. OPTIONS FOR BUILDING xgrabsc
  56.  
  57. The file config.h contains all the configuration options for xgrabsc.
  58. Please take a moment to look through that file before building xgrabsc.
  59.  
  60. You also have the choice of building either the Athena or Motif version of
  61. the xgrab form.  The default is to build the Athena version since many people
  62. don't have Motif yet.  If you have some version of OSF's Motif include and
  63. library files and you want to build the Motif version of the xgrab form,
  64. you will have to edit the Imakefile or simple.mak before building.
  65.  
  66. For VMS there are MMS files for building xgrabsc that were contributed by
  67. a user.  There are no files for building the windowed xgrab interface as
  68. yet.  If you come up with some, please send them to me.
  69.  
  70. BUILDING xgrabsc
  71.  
  72. Xgrabsc should build easily enough.  If you don't have the imake
  73. program, use simple.mak (i.e., make -f simple.mak).  There are targets
  74. for xgrabsc, xgrab, install, install.man, and clean.
  75.  
  76. If you use simple.mak you will have to edit the file to put in the installed
  77. locations of various files.
  78.  
  79. E.g.,
  80.   xmkmf
  81.   make
  82.   make install
  83.   make install.man
  84.  
  85. The install target will put xgrabsc in /usr/bin/X11 and the man page in
  86. /usr/man/man1, unless you are using imake and your configuration files
  87. specify alternative directories.  If you are using simple.mak and don't
  88. like these locations, change the makefile before installing.
  89.  
  90. Please send comments, bugs, and enhancements to bruce@slc.com.  Please
  91. read the Bugs file before sending bug reports.
  92.  
  93.  
  94.  Manifest
  95.  ---------------------------------
  96.  README              this file
  97.  README.xx_yy        files describing incremental changes to xgrabsc
  98.  
  99.  Acks                acknowledgements for code gleaned from other
  100.                      systems, and people who have been very helpful
  101.                      in adding features and removing bugs from xgrabsc
  102.  
  103.  Bugs                known bugs - read this before sending bug reports
  104.  
  105.  Imakefile           Input for "imake" program
  106.  simple.mak          Simpler input for standard "make"
  107.  hp.mak             A version of simple.mak for HPUX 9.0, which comes with
  108.               Motif1.2
  109.  
  110.  checkvm.h           Memory-check Postscript operator
  111.  config.h            Configuration options
  112.  cpyright.h          Copyright notice for this software (READ IT)
  113.  cmdopts.h         Command line options for xgrabsc
  114.  patchlevel.h        Current patch level
  115.  virtual.h           Support for virtual window managers
  116.  xgrabxm.c           Source for Motif 1.2 window interface to xgrabsc
  117.  xgrabxaw.c         Source for the Athena window interface to xgrabsc
  118.  xgrabsc.c           Program source for the screen grabber
  119.  
  120.  *.hc                function include files for xgrabsc.c
  121.  
  122.  XWDfile.h           xwd structure definition needed on some platforms
  123.  
  124.  ad2c.sed            sed script to convert XGrab.ad to fallback resources
  125.                      for xgrab (see Ack file - this isn't mine)
  126.  
  127.  xgrabsc.man         Man page for xgrabsc
  128.  xgrab.man           Man page for xgrab
  129.  
  130.  XGrabxm.res         Resources for the Motif xgrab program
  131.  XGrabxaw.res         Resources for the Athena xgrab program
  132.  
  133.  VMS.mms             VMS build file for xgrabsc
  134.  vmssc.opt           options file for VMS build
  135.  
  136. BUGS:
  137.  
  138. Common problems and known bugs are described in the Bugs file.
  139.  
  140.  
  141.  
  142. TO DO:
  143.  
  144. Support for 24-bit displays.  If someone wants to give this a shot, please
  145. let me know.
  146.  
  147.  
  148. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  149.   Bruce Schuchardt          bruce@SLC.COM
  150.   Servio Corp.
  151.   Beaverton, OR
  152.